Copyright ã1995 by NeXT Computer, Inc.  All Rights Reserved.

Single-Operator Functions

The single-operator functions listed here begin with the prefix ªPS.º  For every single-operator function with a ªPSº prefix, there's a corresponding single-operator function with a ªDPSº prefix.  The PS and DPS functions are identical except that DPS functions take an additional (first) argument that represents the PostScript execution context.  To conserve space, only the single-operator functions prefixed with ªPSº are listed here.  (See ªSuggested Readingº for references to documentation about Display PostScript.)

Besides using the standard C types, these single-operator functions use boolean and userobject.  A boolean variable is an int having either a zero or a nonzero value.  The zero value is equivalent to the PostScript value false, and the nonzero value is equivalent to the PostScript value true.  The userobject type is an int that refers to the value returned by DPSDefineUserObject().   

void	PSabs(void)

void	PSadd(void)

void	PSadjustcursor(float deltaX, float deltaY)²

void	PSaload(void)

void	PSalphaimage(void)²

void	PSanchorsearch(boolean *pflag)

void	PSand(void)

void	PSarc(float x, float y, float radius, float angle1, float angle2)

void	PSarcn(float x, float y, float radius, float angle1, float angle2)

void	PSarct(float x1, float y1, float x2, float y2, float radius)

void	PSarcto(float x, float y, float x2, float y2, float radius, float *pxt1, float *pyt1, float *pxt2, float *pyt2)

void	PSarray(int length)

void	PSashow(float x, float y, char *string)

void	PSastore(void)

void	PSatan(void)

void	PSawidthshow(float x, float y, int c, float ax, float ay, char *string)

void	PSbasetocurrent(float x, float y, float *px, float *py)²

void	PSbasetoscreen(float x, float y, float *px, float *py)²

void	PSbegin(void)

void	PSbind(void)

void	PSbitshift(int shift)

void	PSbuttondown(boolean *pflag)²

void	PSbytesavailable(int *pcount)

void	PScachestatus(int *pbsize, int *pbmax, int *pmsize)

void	PSceiling(void)

void	PScharpath(char *string, boolean flag)

void	PSclear(void)

void	PScleardictstack(void)

void	PScleartomark(void)

void	PScleartrackingrect(int tRectNum, userobject gstate)²

void	PSclip(void)

void	PSclippath(void)

void	PSclosefile(void)

void	PSclosepath(void)

void	PScolorimage(void)

void	PScomposite(float x, float y, float width, float height, userobject srcGstate, float destx, float desty, int op)²

void	PScompositerect(float destx, float desty, float width, float height, int op)²

void	PSconcat(float m[6])

void	PSconcatmatrix(void)

void	PScondition(void)

void	PScopy(int n)

void	PScopypage(void)
Warning:  This function has no effect in NeXTSTEP.

void	PScos(void)

void	PScount(int *pn)

void	PScountdictstack(int *plength)

void	PScountexecstack(int *pcount)

void	PScountframebuffers(int *pcount)²

void	PScountscreenlist(int context, int *pcount)²

void	PScounttomark(int *pn)

void	PScountwindowlist(int context, int *pcount)²

void	PScshow(char *string)

void	PScurrentactiveapp(int *pcontext) 
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentalpha(float *pcoverage)²

void	PScurrentblackgeneration(void)

void	PScurrentcacheparams(void)

void	PScurrentcmykcolor(float *pc, float *pm, float *py, float *pk)

void	PScurrentcolor(void)

void	PScurrentcolorrendering(void)

void	PScurrentcolorscreen(void)

void	PScurrentcolorspace(void)

void	PScurrentcolortransfer(void)

void	PScurrentcontext(int *pcontext)

void	PScurrentdash(void)

void	PScurrentdefaultdepthlimit(int *plimit)²
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentdeviceinfo(userobject window, int *pMinBPS, int *pMaxBPS, int *pColor)²

void	PScurrentdevparams(char *device)

void	PScurrentdict(void)

void	PScurrenteventmask(userobject window, int *pmask)
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentfile(void)

void	PScurrentflat(float *pflatness)

void	PScurrentfont(void)

void 	PScurrentframebuffertransfer(void)

void	PScurrentglobal(int *b)

void	PScurrentgray(float *pgray)

void	PScurrentgstate(userobject gstate)

void	PScurrenthalftone(void)

void	PScurrenthalftonephase(float *px, float *py)

void	PScurrenthsbcolor(float *ph, float *ps, float *pb)

void	PScurrentlinecap(int *plinecap)

void	PScurrentlinejoin(int *plinejoin)

void	PScurrentlinewidth(float *pwidth)

void	PScurrentmatrix(void)

void	PScurrentmiterlimit(float *plimit)

void	PScurrentmouse(userobject window, float *px, float *py)
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentobjectformat(int *pcode)

void 	PScurrentoverprint(int *b)

void	PScurrentowner(userobject window, int *pcontext)²

void	PScurrentpacking(boolean *pflag)

void 	PScurrentpagedevice(void)

void	PScurrentpoint(float *px, float *py)

void	PScurrentrgbcolor(float *pr, float *pg, float *pb)

void	PScurrentrusage(float *pnow, float *puTime, float *psTime, int *pmsgSend, int *pmsgReceive, int *pnSignals, int *pnVCSw, int *pnIvCSw)²

void	PScurrentscreen(void)

void	PScurrentshared(boolean *pflag)

void 	PScurrentshowpageprocedure(void)

void	PScurrentstrokeadjust(boolean *pflag)

void 	PScurrentsystemparams(void)

void	PScurrenttobase(float x, float y, float *px, float *py)²

void	PScurrenttoscreen(float x, float y,float *px, float *py)²

void	PScurrenttransfer(void)

void	PScurrentundercolorremoval(void)

void	PScurrentuser(int *puid, int *pgid)²

void 	PScurrentuserparams(void)

void	PScurrentwaitcursorenabled(boolean *pflag)²

void	PScurrentwindow(int *pnum)²

void	PScurrentwindowalpha(userobject window, int *palpha)²

void	PScurrentwindowbounds(userobject window, float *px, float *py, float *pwidth, float *pheight)²
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentwindowdepth(userobject window, int *pdepth)²
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentwindowdepthlimit(userobject window, int *plimit)²
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentwindowdict(userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PScurrentwindowlevel(userobject window, int *plevel)²

void	PScurrentwriteblock(int *pflag)²

void	PScurveto(float x1, float y1, float x2, float y2, float x3, float y3)

void	PScvi(void)

void	PScvlit(void)

void	PScvn(void)

void	PScvr(void)

void	PScvrs(void)

void	PScvs(void)

void	PScvx(void)

void	PSdef(void)

void	PSdefaultmatrix(void)

void	PSdefinefont(void)

void 	PSdefineresource(char *category)

void	PSdefineusername(int index, char *name)

void	PSdefineuserobject(void)   
Warning:  Use DPSDefineUserObject() instead. 

void	PSdeletefile(char *filename)

void	PSdetach(void)

void	PSdeviceinfo(void)

void	PSdict(int length)

void	PSdictstack(void)

void	PSdissolve(float srcx, float srcy, float width, float height, userobject srcGstate, float destx, float desty, float delta)²

void	PSdiv(void)

void	PSdtransform(float x, float y, float *px, float *py)

void	PSdumpwindow(int level, userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSdumpwindows(int level, userobject context)
Warning:  Don't use this function if you're using the Application Kit.

void	PSdup(void)

void	PSecho(boolean flag)

void	PSend(void)

void	PSeoclip(void)

void	PSeofill(void)

void	PSeoviewclip(void)

void	PSeq(void)

void	PSequals(void)  

void	PSequalsequals(void)   

void	PSerasepage(void)
Warning:  This function is different in NeXTSTEP.

void	PSerrordict(void)

void	PSexch(void)

void	PSexec(void)

void 	PSexecform(void)

void	PSexecstack(void)

void	PSexecuteonly(void)

void	PSexecuserobject(int index) 

void	PSexit(void)

void	PSexp(void)

void	PSfalse(void)

void	PSfile(char *name, char *access)

void	PSfilenameforall(void)

void	PSfileposition(int *ppos)

void	PSfill(void)

void 	PSfilter(void)

void 	PSfindencoding(char *key)

void	PSfindfont(char *name)

void 	PSfindresource(char *key, char *category)

void	PSfindwindow(float x, float y, int place, userobject otherWindow, float *px, float *py, int *pwinFound, boolean *pdidFind)²

void	PSflattenpath(void)

void	PSfloor(void)

void	PSflush(void)

void	PSflushfile(void)

void	PSflushgraphics(void)²
Warning:  Don't use this function if you're using the Application Kit.

void	PSFontDirectory(void)

void	PSfor(void)

void	PSforall(void)

void	PSfork(void)

void	PSframebuffer(int index, int nameLength, char name[], int *pslot, int *punit, int *pROMid, int *px, int *py, int *pwidth, int *pheight, int *pdepth)²

void	PSfrontwindow(int *pnum)
Warning:  Don't use this function if you're using the Application Kit.

void 	PSgcheck(int *b)

void	PSge(void)

void	PSget(void)

void	PSgetboolean(boolean *pflag)

void	PSgetchararray(int size, char string[])

void	PSgetfloat(float *pvalue)

void	PSgetfloatarray(int size, float array[])  

void	PSgetint(int *pvalue)

void	PSgetintarray(int size, float array[])  

void	PSgetinterval(void)

void	PSgetstring(char *string)

void 	PSGlobalFontDirectory(void)

void 	PSglobaldict(void)

void 	PSglyphshow(char *name)

void	PSgrestore(void)

void	PSgrestoreall(void)

void	PSgsave(void)

void	PSgstate(void)

void	PSgt(void)

void	PShidecursor(void)²

void	PShideinstance(float x, float y, float width, float height)²

void	PSidentmatrix(void)

void	PSidiv(void)

void	PSidtransform(float x, float y, float *px, float *py)

void	PSif(void)

void	PSifelse(void)

void	PSimage(void)  

void	PSimagemask(void)

void	PSindex(int n)

void	PSineofill(float x, float y, boolean *pflag)

void	PSinfill(float x, float y, boolean *pflag)

void	PSinitclip(void)

void 	PSiniteventtimes(void)

void	PSinitgraphics(void)
Warning:  This function is different in NeXTSTEP.

void	PSinitmatrix(void)

void	PSinitviewclip(void)

void	PSinstroke(float x, float y, boolean *pflag)

void	PSinueofill(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)

void	PSinufill(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)

void	PSinustroke(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)

void	PSinvertmatrix(void)

void	PSISOLatin1Encoding(void)

void	PSitransform(float x, float y, float *px, float *py)

void	PSjoin(void)

void	PSknown(boolean *pflag)

void	PSkshow(char *string)

void 	PSlanguagelevel(int *n)

void	PSle(void)

void 	PSleftbracket(void)

void 	PSleftleft(void)

void	PSlength(int *pn)

void	PSlineto(float x, float y)

void	PSln(void)

void	PSload(void)

void	PSlock(void)

void	PSlog(void)

void	PSloop(void)

void	PSlt(void)

void	PSmachportdevice(int w, int h, int bbox[], int bboxSize, float matrix[], char *phost, char *pport, char *ppixelDict)²

void	PSmakefont(void)

void 	PSmakepattern(void)

void	PSmark(void)

void	PSmatrix(void)

void	PSmaxlength(int *plength)

void	PSmod(void)

void	PSmonitor(void)

void	PSmoveto(float x, float y)

void	PSmovewindow(float x, float y, userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSmul(void)

void	PSne(void)

void	PSneg(void)

void	PSnewinstance(void)²

void	PSnewpath(void)

void	PSnextrelease(int size, char string[])²

void	PSnoaccess(void)

void	PSnot(void)

void	PSnotify(void)

void	PSnull(void)

void	PSnulldevice(void)

void	PSobscurecursor(void)²

void	PSor(void)

void	PSorderwindow(int place, userobject otherWindow, userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSosname(int size, char string[])²

void	PSostype(int *ptype)²

void	PSpackedarray(void)

void	PSpathbbox(float *pllx, float *plly, float *purx, float *pury)

void	PSpathforall(void)

void	PSplacewindow(float x, float y, float width, float height, userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSplaysound(char *name, int priority)²

void	PSpop(void)

void	PSposteventbycontext(int type, float x, float y, int time, int flags, int window, int subtype, int data1, int data2, int context, boolean *psuccess )²

void	PSprint(void)

void 	PSprinteventtimes(void)

void	PSprintobject(int code)

void 	PSproduct(void)

void	PSprompt(void)

void	PSpstack(void)

void	PSput(void)

void	PSputinterval(void)

void	PSquit(void)

void	PSrand(void)

void	PSrcheck(boolean *pflag)

void	PSrcurveto(float x, float y, float x2, float y2, float x3, float y3)

void	PSread(boolean *pflag)

void	PSreadhexstring(boolean *pflag)

void	PSreadimage(void)²

void	PSreadline(boolean *pflag)

void	PSreadonly(void)

void	PSreadstring(boolean *pflag)

void	PSrealtime(int *pi)

void	PSrectclip(float x, float y, float width, float height)

void	PSrectfill(float x, float y, float width, float height)

void	PSrectstroke(float x, float y, float width, float height)

void	PSrectviewclip(float x, float y, float width, float height)

void	PSrenamefile(char *old, char *new)

void	PSrepeat(void)

void	PSresetfile(void)

void 	PSresourceforall(char *category)

void 	PSresourcestatus(char *key, char *category, int *b)

void	PSrestore(void)

void	PSrevealcursor(void)²

void	PSreversepath(void)

void 	PSrevision(int *n)

void 	PSrightbracket(void)

void	PSrightbuttondown(boolean *pflag)²

void 	PSrightright(void)

void	PSrightstilldown(int eventNum, boolean *pflag)²

void	PSrlineto(float x, float y)

void	PSrmoveto(float x, float y)

void 	PSrootfont(void)

void	PSroll(int n, int j)

void	PSrotate(float angle)

void	PSround(void)

void	PSrrand(void)

void	PSrun(char *name)

void	PSsave(void)

void	PSscale(float sx, float sy)

void	PSscalefont(float size)

void	PSscheck(boolean *pflag)

void	PSscreenlist(int context, int count, int windows[])²

void	PSscreentobase(float x, float y, float *px, float *py)²

void	PSscreentocurrent(float x, float y, float *px, float *py)²

void	PSsearch(boolean *pflag)

void	PSselectfont(char *name, float scale)

void	PSsendboolean(boolean flag)

void	PSsendchararray(char string[], int size)

void	PSsendfloat(float value)

void	PSsendfloatarray(float array[], int size)

void	PSsendint(int value)

void	PSsendintarray(int array[], int size)

void	PSsendstring(char *string)

void 	PSserialnumber(int *n)

void	PSsetactiveapp(int context)
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetalpha(float coverage)²

void	PSsetautofill(boolean flag, userobject window)²

void	PSsetbbox(float llx, float lly, float urx, float ury)

void	PSsetblackgeneration(void)

void	PSsetcachedevice(float wx, float wy, float llx, float lly, float urx, float ury)

void	PSsetcachelimit(float num)

void	PSsetcacheparams(void)

void	PSsetcharwidth(float wx, float wy)

void	PSsetcmykcolor(float c, float m, float y, float k)

void 	PSsetcolor(void)

void 	PSsetcolorrendering(void)

void	PSsetcolorscreen(void)

void 	PSsetcolorspace(void)

void	PSsetcolortransfer(void)

void	PSsetcursor(float x, float y, float mx, float my)²

void	PSsetdash(float pattern[], int size, float offset)

void	PSsetdefaultdepthlimit(int limit)²
Warning:  Don't use this function if you're using the Application Kit.

void 	PSsetdevparams(void)

void	PSseteventmask(int mask, userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetexposurecolor(void)²

void	PSsetfileposition(int pos)

void	PSsetflat(float flatness)

void	PSsetflushexposures(boolean flag)²

void	PSsetfont(userobject font)

void 	PSsetframebuffertransfer(void)

void 	PSsetglobal(int b)

void	PSsetgray(float num)

void	PSsetgstate(userobject gstate)

void	PSsethalftone(void)

void	PSsethalftonephase(float x, float y)

void	PSsethsbcolor(float hue, float sat, float brt)

void	PSsetinstance(boolean flag)²

void	PSsetlinecap(int linecap)

void	PSsetlinejoin(int linejoin)

void	PSsetlinewidth(float width)

void	PSsetmatrix(void)

void	PSsetmiterlimit(float limit)

void	PSsetmouse(float x, float y)²

void	PSsetobjectformat(int code)

void 	PSsetoverprint(int b)

void	PSsetowner(userobject context, userobject window)²

void	PSsetpacking(boolean flag)

void 	PSsetpagedevice(void)

void 	PSsetpattern(int patternDict)

void	PSsetrgbcolor(float red, float green, float blue) 

void	PSsetscreen(void)

void	PSsetsendexposed(boolean flag, userobject window)²
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetshared(boolean flag)

void 	PSsetshowpageprocedure(int win)²
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetstrokeadjust(boolean flag)

void 	PSsetsystemparams(void)

void	PSsettrackingrect(float x, float y, float width, float height, boolean leftFlag, boolean rightFlag, boolean inside, int userData, int trectNum, userobject gstate)²

void	PSsettransfer(void)

void	PSsetucacheparams(void)

void	PSsetundercolorremoval(void)

void 	PSsetuserparams(void)

void	PSsetvmthreshold(int i)

void	PSsetwaitcursorenabled(boolean flag)²

void	PSsetwindowdepthlimit(int limit, userobject window)²
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetwindowdict(userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetwindowlevel(int level, userobject window)²

void	PSsetwindowtype(int type, userobject window)²
Warning:  Don't use this function if you're using the Application Kit.

void	PSsetwriteblock(int flag)²

void	PSshareddict(void)

void	PSSharedFontDirectory(void)

void	PSshow(char *string)

void	PSshowcursor(void)²

void	PSshowpage(void)
Warning:  This function is different in NeXTSTEP.

void	PSsin(void)

void	PSsizeimage(float x, float y, float width, float height, int *ppixelsWide, int *ppixelsHigh, int *pbitsPerSample, float matrix[], boolean *pmultiProc, int *pnColors)²

void	PSsqrt(void)

void	PSsrand(void)

void	PSstack(void)

void	PSStandardEncoding(void)

void	PSstart(void)

void 	PSstartjob(int b, char *password)

void	PSstatus(boolean *pflag)

void	PSstatusdict(void)

void	PSstilldown(int eventNum, boolean *pflag)²

void	PSstop(void)

void	PSstopped(void)

void	PSstore(void)

void	PSstring(int length)

void	PSstringwidth(char *string, float *px, float *py)

void	PSstroke(void)

void	PSstrokepath(void)

void	PSsub(void)

void	PSsystemdict(void)

void	PStermwindow(userobject window)
Warning:  Don't use this function if you're using the Application Kit.

void	PStoken(boolean *pflag)

void	PStransform(float x, float y, float *px, float *py)

void	PStranslate(float x, float y)

void	PStrue(void)

void	PStruncate(void)

void	PStype(void)

void	PSuappend(char nums[], int n, char ops[], int l)

void	PSucache(void)

void	PSucachestatus(void)

void	PSueofill(char nums[], int n, char ops[], int l)

void	PSufill(char nums[], int n, char ops[], int l)

void	PSundef(char *name)

void	PSundefinefont(char *name)

void 	PSundefineresource(char *key, char *category)

void	PSundefineuserobject(int index)

void	PSupath(boolean flag)

void	PSuserdict(void)

void	PSuserobject(void)

void	PSusertime(int *pmillisecs)

void	PSustroke(char nums[], int n, char ops[], int l)

void	PSustrokepath(char nums[], int n, char ops[], int l)

void	PSversion(int bufsize, char buf[])

void	PSviewclip(void)

void	PSviewclippath(void)

void	PSvmreclaim(int code)

void	PSvmstatus(int *plevel, int *pused, int *pmax)

void	PSwait(void)

void	PSwcheck(boolean *pflag)

void	PSwhere(boolean *pflag)

void	PSwidthshow(float x, float y, int c, char *string)

void	PSwindow(float x, float y, float width, float height, int type, int *pwindow)
Warning:  Don't use this function if you're using the Application Kit.

void	PSwindowdevice(userobject window)²

void	PSwindowdeviceround(userobject window)²

void	PSwindowlist(int context, int count, int windows[])²

void	PSwrite(void)

void	PSwritehexstring(void)

void	PSwriteobject(int code)

void	PSwritestring(void)

void	PSwtranslation(float *px, float *py)

void	PSxcheck(boolean *pflag)

void	PSxor(void)

void	PSxshow(char *string, float numArray[], int size)

void	PSxyshow(char *string, float numArray[], int size)

void	PSyield(void)

void	PSyshow(char *string, float numArray[], int size)